home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / cl14s23a.zip / CALLS.MOD < prev    next >
Text File  |  1992-03-01  |  20KB  |  420 lines
  1. This is an addendum to CAL14S23.ZIP and contains a new version of CALLS.EXE
  2. which addresses the problems or new features listed below. A sample CALLS.CNF
  3. is also included as several new entries have been added.
  4.  
  5. Problems:
  6.  
  7. 1:  With the new feature of PCBoard 14.5a that allows single character Door
  8.     names, CALLS.EXE locks up.
  9.  
  10.     Fixed the routine that found the Door name and stripped off the path
  11.     information.
  12.  
  13. 2:  Non ANSI callers were ignored (those with (A) in the log), only (N) & (G)
  14.     graphics modes were being recognized.
  15.  
  16.     Added Non ANSI as graphics mode (A) so now all three modes are reported.
  17.  
  18. 3:  Sysop sessions were ignored when PCBoard was setup to use the Sysops true
  19.     name instead of just SYSOP.
  20.  
  21.     Added SYSOPNAME option to config file to allow recognizing the Sysop
  22.     in the caller log when the full name is used instead of SYSOP. If not
  23.     given the default is SYSOP.
  24.  
  25. 4:  Average Event Length always showed ZERO for my board, as the first event
  26.     activity was RNET which writes entries to the log that duplicate a User
  27.     logon and CALLS.EXE considers the Event to end the first caller entry.
  28.     This also causes problems that the Event does not terminate timing until
  29.     a caller logs on and this does not reflect event duration properly.
  30.  
  31.     Added support for RNET that causes CALLS to not stop timing an event if
  32.     it sees the FirstName is RNET.EXE. Also Added EXCLUDENAME to allow skipping
  33.     another program like RNET.EXE that appears to log on as a User in the log.
  34.     If the first name of the User matches the EXCLUDENAME it is skipped.
  35.     (Also now allowed to specify up to 10 EXCLUDENAME entries)
  36.  
  37.     Added the recognition of the line:
  38.  
  39.        Scheduled Event ended at MM-DD-YY HH:MM:SS
  40.  
  41.     to properly end the event time calculations rather than continuing time
  42.     until a caller logs on. This entry can be created by using a utility to
  43.     write lines to callers log. (Like my CL-PRINT.COM program.)
  44.  
  45.     Added Event program report. Using the line
  46.  
  47.        Event: program name started at HH:MM:SS MM-DD-YY
  48.  
  49.     will begin the timing of an event program. Timing will end when another
  50.     line starting with 'Event: ' is detected, the Scheduled Event ended line
  51.     is detected or a User logon is deteced. The Number of times each program
  52.     is executed and total time is tracked and a report of Average time is
  53.     generated.
  54.  
  55.                        -= Average Event Program Times =-
  56.  
  57.                  Norton Speed Disk:     5 Times    31.6 Min Avg.
  58.                             Backup:     5 Times    10.6 Min Avg.
  59.                            PCBFile:     5 Times     6.2 Min Avg.
  60.                      Call Analyzer:     5 Times     1.6 Min Avg.
  61.  
  62. 5.  Connect Type Report is not working.
  63.  
  64.     Added recognition of 'Modem:' as connect type for PCBoard 14.x
  65.     compatability.
  66.  
  67.     Added RINGFILTER ON/OFF to control removal of RING from CONNECT type
  68.     report. Also removes any additional text after the CONNECT XXXXXXXXX
  69.     message.
  70.  
  71. 6.  Batch Size Report is not working. (FREE Downloads also not working)
  72.  
  73.     PCBoard 14.5a now supplies Batch transfer report, added support for
  74.     the format of this data so that this report now works.
  75.  
  76.     PCBoard does not flag FREE or NO TIME Downloads in any way in the
  77.     caller log so this report can not 'easily' be made to work. The
  78.     amount of time the report would spend attempting to decide if a file
  79.     was FREE or not would not be worth it. If future versions of PCBoard
  80.     do note this in the caller log, I will get this report to work.
  81.  
  82. 7.  PCBVerify's report of "XXX-XXX-XXXX Added to trashcan" causes security
  83.     violation counts.
  84.  
  85.     Fixed.
  86.  
  87. 8.  Sysop paged after hours, not counted.
  88.  
  89.     Created seperate counter for this, along with report of Chat Time.
  90.     Added Node chat also
  91.  
  92.     Added CHATMODE and NODEMODE which operate similar to EVENTMODE but
  93.     control Sysop Chat and Node Chat timing. But I recommend that they be
  94.     set to IDLE in most cases, Unless you find they need to be changed.
  95.  
  96. 9.  Messages left count did not include RNET imported messages, ZIPM
  97.     messages showed import & export count.
  98.  
  99.     Made RNET import messages show in messages left count and also in
  100.     ZIPM (changed name to MAIL) count. RNET import counts as MAIL
  101.     executed.
  102.  
  103. 10. Log off scripts did not count in Scripts Completed.
  104.  
  105.     Made seperate counter for this.
  106.  
  107. 13. Added configuration variable REPORTTYPE to control output generated.
  108.     ASCII will generate non-color version, ANSI will generate 'G' color
  109.     version, and BOTH will generate both (Default).
  110.  
  111.     Added ReportType of PCBOARD to generate a single outputfile using
  112.     PCBoard @Xnn color codes
  113.  
  114. 12. Added additional reports of Users who leave messages and Which Conference
  115.     is getting message traffic.
  116.  
  117.     Added MAXMSGS & MAXUSERS to control new reports of Conference Messages
  118.     Left & User Messages Left
  119.  
  120. 13. Added additional reports for reasons logged off and security violations.
  121.  
  122. Added Sysop Statistics 'S' report
  123.  
  124.   Sysop Local Sessions...       x         Node Chats Initiated...       x
  125.   Sysop Remote Sessions..       x         Node Chat Time (min)...       x
  126.   Remote DOS Time (min)..       x         Sysop Chats Initiated..       x
  127.   Remote Drops to DOS....       x         Sysop Chat Time (min)..       x
  128.   SHELL Executed.........       x         Sysop Paged............       x
  129.   Text Files Viewed......       x         Sysop Paged after Hours       x
  130.   Caller log Viewed......       x         Temporary Sysop Priv...       x
  131.  
  132. Added User Statistics 'R' report
  133.  
  134.   Protocol Changes.......       x         Expert mode Toggled....       x
  135.   User Record Updates....       x         Graphic Mode Toggled...       x
  136.   Language Changes.......       x         Page Length Changes....       x
  137.  
  138.  
  139. Changed Security Statistics 'N' report
  140.  
  141.   Automatic Lockouts.....       x         Security Violations....       x
  142.   Trashcan Names.........       x         Attempted Alias Logon..       x
  143.   Excessive Passwords....       x         Password Failures......       x
  144.   Refused Registration...       x         Non-Registered Users...       x
  145.   Time Limit Expired.....       x         Not Registered in Conf.       x
  146.   Keyboard Timeouts......       x         Dropped Carrier........       x
  147.   Insufficient D/L Time..       x         Dropped Carrier in Door       x
  148.   Insufficient Bytes/File       x         Missing Level in PWRD..       x
  149.   Automatic Disconnects..       x         Door Selected UnAvail..       x
  150.  
  151. Moved Scheduled Event & Event Time and Added Logoff Scripts Completed
  152. to Systems Statistic 'A' report.
  153.  
  154.   Directory Scans........       x         Messages Left..........       x
  155.   Doors Opened...........       x           Comments Left........       x
  156.     Time spent in Doors..   xx:xx           MailDoor Messages....       x
  157.   Downloads Completed....       x           Mail Packets DLed....       x
  158.     Different Files......       x           Net MAIL Executed....       x
  159.     Downloads Aborted....       x           Net MAIL Messages....       x
  160.     Free Downloads.......       x         Number of Callers......       x
  161.   REPACK Executed........       x           New Users Registered.       x
  162.   TEST Executed..........       x           Ave. Calls Per Day...     x.x
  163.   Uploads Completed......       x           Ave. Call Duration...     x.x
  164.     Bad Uploads Deleted..       x           Ave. Idle Time.......     x.x
  165.     Uploads Aborted......       x         Scripts Completed......       x
  166.   VIEW Executed..........       x         Logoff Script Completed       x
  167.     Members Extracted....       x         Total Operation Hours..     x.x
  168.     Members Viewed.......       x           Utilization Hours....     x.x
  169.   Scheduled Events.......       x           Total Utilization %..     x.x
  170.   Ave Event Length (min).     x.x           Peak Utilization %...     x.x
  171.   LIB Executed...........       x         Time System locked up..     x.x
  172.  
  173. 14. Fixed problem with security levels being duplicated in .SAV file due to
  174.     spaces stripped off of first entry only.
  175.  
  176. 15. Changed output structure of fileames in .SAV file to save space.
  177.  
  178. 16. Added Language report by placing Language Number in Modem connect string
  179.         ie. Modem (1): CONNECT 2400
  180.     or Caller Number string
  181.         ie. Caller Number (1): 12345
  182.     or Security Level string
  183.         ie. Caller Security (1): 50
  184.  
  185.     This is accomplished by using MKTXT145 to modify the record for the
  186.     'Modem: @OPTEXT@' (rec no 590), 'Caller Number: @OPTEXT@' (rec no 591)
  187.     or 'Caller Security: @OPTEXT@' (rec no 592) and adding the text (n) to
  188.     the current text as shown above (where n is the language number, ie.
  189.     for your first language you add (1), for your second language PCBTEXT
  190.     file you add (2), etc...)
  191.  
  192. 17. Found limitation in graph routines that limited lists to 100 items, which
  193.     caused loss of many Names, Conference Bulletins, Conferences joined if
  194.     any list execeed that number of items, incresed limit to 500 which should
  195.     be sufficient for most systems, if not change the const (graph_num).
  196.  
  197. 18. Added FILENAMES to control the saving of filenames and Counts to the
  198.     History File.
  199.  
  200. 19. Added FILTERFILE Masks to allow filtering filenames from report and
  201.     history file. Wildcards are allowed and a special '#' wildcard will
  202.     match another '#' or a digit ('0' - '9') to aid in filtering capture
  203.     file downloads (#####?.ZIP and #####?.CAP).
  204.  
  205. 20. Allowed for 10 EXCLUDENAME Entries & 10 FILTERFILE Masks Entries
  206.  
  207. 21. Added Last-On Report, requires using program like CL-PRINT V2.0 to
  208.     write a line to the CALLER log file in the format of
  209.  
  210.     Last On: MM-DD-YY (HH:MM)
  211.     or
  212.     Last On: MM-DD-YY (HH:MM) for nn Minute(s)
  213.     or
  214.     Last On: MM-DD-YY (HH:MM) for nn Minute(s) - #nnnn
  215.  
  216.     The report format look like this:
  217.  
  218.                             -= Last Called In =-
  219.  
  220.      Within One Week:   129 (19.9%) │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░█
  221.         Previous Day:   112 (17.3%) │▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓█
  222.             Same Day:    99 (15.3%) │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒█
  223.     Within Two Weeks:    36 ( 5.5%) │░░░░░░░░░░░█
  224.     Within One Month:    32 ( 4.9%) │▓▓▓▓▓▓▓▓▓▓█
  225.            New Users:    24 ( 3.7%) │▒▒▒▒▒▒▒█
  226.    Within Two Months:    16 ( 2.5%) │░░░░█
  227.   Within Four Months:    12 ( 1.8%) │▓▓▓█
  228.    Within Six Months:    10 ( 1.5%) │▒▒█
  229.   Within Nine Months:     4 ( 0.6%) │█
  230.     Within Two Years:     4 ( 0.6%) │█
  231.       Over Two Years:     1 ( 0.2%) │
  232.      Within One Year:     1 ( 0.2%) │
  233.  
  234.  
  235.     Example:
  236.  
  237.     CL-PRINT C:\PCB\MAIN\CALLER /Q,/S,"Last On: @D (@T)"
  238.     or
  239.     CL-PRINT C:\PCB\MAIN\CALLER /Q,/Z,/S,"Last On: @D (@T) for @M Minute(s)"
  240.     or
  241.     CL-PRINT C:\PCB\MAIN\CALLER "/Q/Z/SLast On: @D (@T) for @M Minute(s) - #@#"
  242.  
  243.     This example can be run in your $$LOGON.BAT
  244.  
  245. NOTE: SHARE must be loaded if you intend to write to the CALLER log during
  246.       $$LOGON.BAT or $$LOGON.BAT as PCBoard has the file open and has written
  247.       entries to it prior to calling the batch files. If SHARE is not loaded
  248.       you will write over the top of the entries PCBoard has made. Also,
  249.       this can only be done on Network verisons /E & /U and you CAN NOT
  250.       use it on /D or /S versions as PCBoard has the USERS file open in
  251.       DENY READ/WRITE on these versions, so the file can not be opened by
  252.       CL-PRINT to obtain the information desired.
  253.  
  254.  
  255. 22. Changed files downloaded report to not generate an ANSI sequence when
  256.     there is no change in color.
  257.  
  258. 23. Added more support for Southern Style & Three Stooges Language file
  259.     entries in CALLERS log.
  260.  
  261. 24. Added CATCHALLREPORT Variable to log text lines passing thru the
  262.     Catchall routine to assist in changing the line parsing routines.
  263.  
  264. 25. Added MAIL Door support. QMail, MarkMail & Cam-Mail entries are all
  265.     recognized and a seperate report for each Mail Door is supported.
  266.     All three reports are the same and the titles can be changed to
  267.     anything so if it works for other mail doors you now have a report.
  268.     (If it does'nt work, send some sample caller log entries to me and
  269.     I will try to add support, I might add control over which entries
  270.     are printed so those which are not applicable to a particular door
  271.     can be skipped).
  272.  
  273. 26. Added support for a few junk entries (like CALLER NUMBER:) to speed up
  274.     report by recognizing the entry sooner. And to support imbedding the
  275.     Language number in Caller Number as well. (See item #16 above)
  276.  
  277. 27. Added support and a report for a User Definable Door. (Door U / Y8)
  278.     Text to be scanned for may be defined (up to 20 variables) and
  279.     The Text to be used in the Report may be defined. Undefined variables
  280.     will not be scanned for or reported. Special handling is defined for
  281.     entries that would indicate the Door logged the caller off, and
  282.     entries which should not be counted if the Door logged the User off.
  283.     (this allows for not counting CARRIER LOST as a User Hang up if it
  284.     was the door that dropped carrier.)  Also printing '...' or blank
  285.     entries in the report to allow lining up report when skipping variables
  286.     or using an odd number of variables. Count of times Door used and
  287.     logging off in door and Time Spent in Door are always reported for
  288.     the Door, so no special handling for this is needed.
  289.  
  290. 28. Added changes from CAL14S22.ZIP & CAL14S23.ZIP to this release.
  291.  
  292. 29. Added Message Statistic Report.
  293.  
  294.                           -= Message Statistics =-
  295.  
  296.   Messages Left..........       x         MailDoor Messages......       x
  297.          Via PCBoard.....    xx.x%               Via Mail Doors..    xx.x%
  298.     Comments Left........       x           Mail Packets DLed....       x
  299.     Messages Moved.......       x                        Aborted.       x
  300.     Messages Copied......       x           Reply Packets Uled...       x
  301.     Messages Restored....       x                        Aborted.       x
  302.     Messages Deleted.....       x           Net MAIL Executed....       x
  303.   Message Entry Aborted..       x           Net MAIL Messages....       x
  304.   Message Base Packed....       x         No Room for text.......       x
  305.  
  306. 30. Added SECLABEL variable to define text to be added to Security Level
  307.     reports, and NOSECLABEL variable to define text for no level.
  308.  
  309. 31. Corrected Door timing routines to properly time a Door when User
  310.     Logged off in Door and a Back From Dos entry did not exist. If
  311.     you Run PCBVerify (or some other Door from your InstaReg batch
  312.     file, instead of returning to the BBS first, you can use CL-PRINT
  313.     to insert a line:
  314.  
  315.     Opened Door (VERIFY) at HH:MM Via InstaReg
  316.  
  317.     ie.
  318.  
  319.     CL-PRINT C:\PCB\MAIN\CALLER /Q,/S,"Opened Door (VERIFY) at /T Via InstaReg"
  320.  
  321.     This will cause CALLS to stop timing the InstaReg Door and start
  322.     timing the new Door (ie. VERIFY) and accumlate the information on
  323.     the proper Door.
  324.  
  325. 32. Changed report format for many of the Doors to make them consistent
  326.     with one another and to add a couple of entries.
  327.  
  328. 33. Added seperate reports for Hangups in Board & in Doors.
  329.  
  330. 34. Added support for PCBVerify 4.0 message changes and minor changes to
  331.     Report for PCBVerify  (VERIFY & CALLBACK)
  332.  
  333. 35. Removed GENERIC & DEFDOORTITLE and replaced with REPORTTITLE to define
  334.     label for any of the report sections
  335.  
  336. 36. Added Report control characters for REPORTS definition
  337.     Z - insert a blank line          . - do nothing character
  338.     @ - insert a @MORE@ prompt       $ - insert a @PAUSE@ prompt
  339.     % - insert a @WAIT@ prompt       * - insert a @CLS@
  340.     if * is first character then a @CLS@ (or ANSI clear screen) will be
  341.     sent at the beginning of bulletin.
  342.  
  343. 37. Added REPORTACTION variable which can be defined with any of the above
  344.     characters. These characters will be used to send strings after EVERY
  345.     report section.   If any of the above characters are included after a
  346.     report directly in REPORTS, then the REPORTACTION will not be sent after
  347.     that report allowing override of REPORTACTION to combine a couple of the
  348.     shorter reports to a single screen.
  349.  
  350. 38. Added a SHORTENGRAPH variable to the .CNF file that will cause the
  351.     Hourly Usage graph to start at the highest used percentage instead
  352.     of at 100% if desired. If a numeric value is used (0 to 100 by 5's
  353.     then that will be the starting point if the highest percentage is
  354.     below that). ie if the highest used percentage was 40 then the graph
  355.     would start at NO = 100%, YES = 40%, 60 = 60%, 20 = 40%.
  356.  
  357. 39. Added a REFUSEDREG variable that combines the Non-Registered value to
  358.     the Refused to Register value in the report. When running your board
  359.     to allow Users to remain on (a non-zero security level assigned to
  360.     those who refuse to register), those Users will show up as Non-Registered
  361.     Users and only those who give a partial name and then refuse to give a
  362.     full name will show up as Refused to Register. If REFUSEDREG is set to
  363.     YES, then both will be combined and reported under Refused to Register
  364.     (although Non-Registered will still be reported). If you set a zero
  365.     security level to those who refuse to register, there shoud be No
  366.     Non-Registered Users reported as PCBoard kicks them off and issues the
  367.     ACCESS DENIED - REFUSED TO REGISTER to the callers log, and I don't think
  368.     will ever use the REFUSED TO REGISTER entry. I had the two backwards in
  369.     previous releases, so some confusion existed.
  370.  
  371. 40. Added LANGUAGE n Text variables to allow defining the name of the
  372.     Languages instead of just the number as before. You can include
  373.     the number in the text as in the example .CNF file. If not defined
  374.     they now default to 'Language 1' etc....
  375.  
  376. 41. Added REPORTEXCLUDE which causes the graph items not to be accumulated
  377.     which can shorten the SAVE file considerably if there are items you
  378.     don't use in your report. The allowable entries are (CEFLOPQRUVWXY!=^-)
  379.     and any other entries will just be ignored.
  380.  
  381. 42. Added report for User Uploads (and a MAXUL setting).
  382.  
  383. 43. Added report for Callers Hanging Up (and a MAXHANGUP setting)
  384.  
  385. 44. Changed the DoorTime reports to HH:MM format from Minutes.
  386.  
  387. 45. Changed all reports to allow for an extra digit in reports as some
  388.     values were exceeding columns when accumulating data for a full year.
  389.  
  390. 46. A few reorganizations in the code as it was starting to exceed code
  391.     segment limitations. (no external appearence changes). Moved some
  392.     of the conversion routines into a seperate UNIT.
  393.  
  394. 47. Color of 'Period covered:' text changed from BLUE to CYAN for better
  395.     readability on most systems.
  396.  
  397. 48. Well, leap year came around and showed me another problem. Fixed the
  398.     month to day calculations to account for leap year. This should keep
  399.     things correct for awhile.
  400.  
  401. 49. Added an EXCLUDEUSER which functions like EXCLUDENAME except it will
  402.     allow excluding a list of Users from the Message Left, Upload &
  403.     Caller Hanging Up reports.
  404.  
  405. 50. Fixed UserName routine to pickup users with more then two names (ie.
  406.     those users who use middle initials, etc...). Name now ends two chars
  407.     before the '(' in the baud rate.
  408.  
  409. If you know of any other problems that exist or some other data that is
  410. not being reported that should be, let me know.  >>>>>Gary Meeker
  411.  
  412. Source code is not included, as I don't wish to distribute modified source
  413. code, but feel other Sysops might benefit from the changes made. If you
  414. need the source code, you can request it from me on my BBS, but I ask
  415. that you do not upload it anywhere else.  For those wishing to compile
  416. you will need mdosio, openshar, qread, ansicrt, dosmem & bufio TPU files
  417. which can be found in PRODOR32.ZIP (or a later release possibly).
  418.  
  419. SHARP Technical Support Line BBS (404) 962-1788 (ATI 9600 Etc.)
  420.